home *** CD-ROM | disk | FTP | other *** search
/ PC-Blue - MS DOS Public Domain Library / PC-Blue MS-DOS Public Domain Library - NYACC.iso / vol330 / gagsdocs.arc / GAGSEDIT.DOC < prev    next >
Encoding:
Text File  |  1986-06-15  |  5.3 KB  |  106 lines
  1.  
  2.                          GAG_EDIT.DOCUMENTATION
  3.  
  4.              The Generic Adventure Game System (GAGS) is a great 
  5.          game generator.  No longer must you sit on the sidelines and 
  6.          play "Someone else's" game.  You can now create your own!  
  7.  
  8.                 First,  of  course,  you  will need to obtain the GAGS 
  9.          program and documentation from Mark Welch (P.O. Box 2409, San 
  10.          Francisco, CA 94126, 415-845-2430) or download it from one of 
  11.          the numerous Bulletin Boards that support him. You can also 
  12.          obtain a (probably) current version from the Fantasy Factory 
  13.          BBS (415) 355-6047.  
  14.  
  15.                 Now  ...  for  the  reason why I wrote this editor.  I 
  16.          hate checking a manual everytime I make an entry into a  file 
  17.          or  write a program.  GAGS is great but,  between you  and I, 
  18.          creating the Play file (as I call it) is a large pain in  the 
  19.          "A--"!  as  you  not only have to lay the whole thing out but 
  20.          also have to remember the syntax of the  command  file.  Then 
  21.          there's the problem of typos.  
  22.  
  23.                 Well  GAG-EDIT.EXE will take care of that for you.  As 
  24.          an example ...  during the testing  phase  of  writting  this 
  25.          program,  I wrote an adventure with 39 rooms,  22 nouns and 3 
  26.          creatures in about 3 hours. Very little planning went into it 
  27.          as I just wanted to test the program ...  and darned  if  the 
  28.          game file didn't work on the first try!  
  29.  
  30.                 GAG_EDIT works entirely  with  pre-formatted  screens.  
  31.          Just follow the simple instructions. To select an option from 
  32.          the menu page simpley enter it's number.  
  33.  
  34.                 On  all the remaining format screens,  you may type in 
  35.          your descriptions,  select options (Use 'X' or 'Y' to  select 
  36.          or 'N' to de-select) and enter numbers as indicated.  
  37.  
  38.                 To  complete  a  screen,  depress the "END" key or hit 
  39.          return a few times to get into the "OK?" field.  Here you may 
  40.          indicate  "Y"  to  store or "N" to continue editing.  You may 
  41.          also type a "Q" to forget the whole thing and return  to  the 
  42.          master menu.  
  43.  
  44.                 Keys  work  as  you  might expect they should.  Return 
  45.          returns,  up arrow moves cursor up,  down arrow moves  cursor 
  46.          down  and so on.  You can insert and delete,  HOME the cursor 
  47.          and ESC to the "OK".  Other keys,  not needed by this  editor 
  48.          will return a little beep but otherwise do nothing.  
  49.  
  50.                 This editor is a full screen,  partial function editor 
  51.          which creates (or appends to) and ASCII file in the form that 
  52.          the GAGS program will accept.  
  53.  
  54.                 One key you should be aware of though is  the  "tilde" 
  55.          key ( ~ ).  This key deletes the contents of a field.   It is 
  56.          needed as this editor validates alpha numeric field  content.  
  57.          As a space is considered an alpha character, you can't "space 
  58.          out" a numeric field. Therefore the "tilde" delete character.  
  59.  
  60.                 I  suspect I havn't found all the bugs in this program 
  61.          yet so if you find and, let me know. You can get me a Fantasy 
  62.          Factory BBS at the number listed above.  
  63.  
  64.                 Please don't bother Mark  Welsh  with  corrections  to 
  65.          this  program  as  he currently does not have the source code 
  66.          for it.  
  67.  
  68.                 This program is here-by offered into the public domain 
  69.          as a 1985 Christmas present to Mark Welsh.  As such I can not 
  70.          be held liable for any injury,  public or  private,  real  or 
  71.          imagined, as a result of using this program.  
  72.  
  73.                          MERRY CHRISTMAS MARK!
  74.  
  75.                                              Ev Cheney, SYSOP
  76.                                              Fantasy Factory BBS
  77.                                              (Really the best BBS!)
  78.                                              Pacifica, CA
  79.                                              (415) 355-6047.  
  80.  
  81.                  
  82.                                   ADDENDUM
  83.  
  84.                 Effective Januay 18th,  1986,  this  program  (Version 
  85.          2.00) supports Mark's newest version of GAGS version 1.06.  
  86.  
  87.                 Three additions have been made. The creatures now have 
  88.          a  "#  TIMES THRESHHOLD" (If you don't get 'em in x number of 
  89.          moves,  Whamo!),  a GAME_WIN option for rooms (You Win if you 
  90.          get there) and an option to redefine GAGS verbs (Ie;  instead 
  91.          of KILL you can define KISS to  replace  it  ie;  KISS  TROLL 
  92.          would be the same as KILL Troll [You old poison breath!]).  
  93.  
  94.                 This  editor  also works with earlier versions of GAGS 
  95.          so long as you don't use the 1.06+  options.  Some  notes  on 
  96.          other versions are: 
  97.  
  98.                 1.)  Versions earlier than 1.05 didn't handle friendly 
  99.          creatures very well.  They  wouldn't  attack,  but  you  also 
  100.          couldn't leave the room.  
  101.  
  102.                 2.)  Versions  earlier than 1.06 had no way of letting 
  103.          the hero get away alive unless  all  the  "points"  had  been 
  104.          collected.  
  105.  
  106.